Skip to content

[DOCSW-615] docs: refresh API reference and add new endpoints#245

Merged
danciaclara merged 7 commits intomasterfrom
refactor-update_developer_docs
Mar 25, 2026
Merged

[DOCSW-615] docs: refresh API reference and add new endpoints#245
danciaclara merged 7 commits intomasterfrom
refactor-update_developer_docs

Conversation

@iam-vipin
Copy link
Member

@iam-vipin iam-vipin commented Mar 16, 2026

Description

The update includes a full pass across docs/api-reference/ to normalize endpoint paths, path parameter names, request/response examples, scopes, and status codes to the latest schema-backed format already used in the docs site.

Key changes included in this PR:

  • Added the missing API reference groups and endpoint pages for assets, project labels, workspace features, project features, workspace invitations, milestones, work item pages, project member CRUD, advanced search, work item property values, work item type schema, work item create, and work item properties.
  • Updated existing API reference families including project, state, label, issue/work item, links, activity, comments, attachments, issue types, cycle, module, page, members, user, worklogs, epics, initiative, customer, teamspace, sticky, intake issue, and inbox issue.
  • Normalized docs to modern route families such as /work-items/, /work-item-types/, and /project-members/, and corrected path placeholder usage to match the literal routes shown in the schema and local API.
  • Reworked request and response examples to use sanitized professional sample values rather than copied live data.
  • Updated the API reference sidebar in docs/.vitepress/config.mts so all newly added pages are discoverable in navigation.
  • Added the missing workspaces.members:write scope to docs/dev-tools/build-plane-app/oauth-scopes.md.

Type of Change

  • Bug fix (non-breaking change which fixes an issue)
  • Feature (non-breaking change which adds functionality)
  • Improvement (change that would cause existing functionality to not work as expected)
  • Code refactoring
  • Performance improvements
  • Documentation update

Screenshots and Media (if applicable)

image
Screen.Recording.2026-03-16.at.6.14.33.PM.mov

References

  • Local source contract: schema.yml

@vercel
Copy link

vercel bot commented Mar 16, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
developer-docs Ready Ready Preview, Comment Mar 25, 2026 1:01pm

Request Review

@coderabbitai
Copy link

coderabbitai bot commented Mar 16, 2026

Important

Review skipped

Too many files!

This PR contains 216 files, which is 66 over the limit of 150.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: e7293f79-b1c3-4554-851b-ceb4452ffb89

📥 Commits

Reviewing files that changed from the base of the PR and between 97c6ad4 and 5684fe6.

📒 Files selected for processing (216)
  • docs/.vitepress/config.mts
  • docs/api-reference/assets/create-user-asset-upload.md
  • docs/api-reference/assets/create-workspace-asset-upload.md
  • docs/api-reference/assets/delete-user-asset.md
  • docs/api-reference/assets/get-workspace-asset.md
  • docs/api-reference/assets/overview.md
  • docs/api-reference/assets/update-user-asset.md
  • docs/api-reference/assets/update-workspace-asset.md
  • docs/api-reference/customer/add-customer-property.md
  • docs/api-reference/customer/add-customer-request.md
  • docs/api-reference/customer/add-customer.md
  • docs/api-reference/customer/delete-customer-property.md
  • docs/api-reference/customer/delete-customer-request.md
  • docs/api-reference/customer/delete-customer.md
  • docs/api-reference/customer/get-customer-detail.md
  • docs/api-reference/customer/get-customer-property-detail.md
  • docs/api-reference/customer/get-customer-property-value.md
  • docs/api-reference/customer/get-customer-request-detail.md
  • docs/api-reference/customer/link-work-items-to-customer.md
  • docs/api-reference/customer/list-customer-properties.md
  • docs/api-reference/customer/list-customer-property-values.md
  • docs/api-reference/customer/list-customer-requests.md
  • docs/api-reference/customer/list-customer-work-items.md
  • docs/api-reference/customer/list-customers.md
  • docs/api-reference/customer/unlink-work-item-from-customer.md
  • docs/api-reference/customer/update-customer-detail.md
  • docs/api-reference/customer/update-customer-property-detail.md
  • docs/api-reference/customer/update-customer-property-value.md
  • docs/api-reference/customer/update-customer-request-detail.md
  • docs/api-reference/cycle/add-cycle-work-items.md
  • docs/api-reference/cycle/add-cycle.md
  • docs/api-reference/cycle/archive-cycle.md
  • docs/api-reference/cycle/delete-cycle.md
  • docs/api-reference/cycle/get-cycle-detail.md
  • docs/api-reference/cycle/list-archived-cycles.md
  • docs/api-reference/cycle/list-cycle-work-items.md
  • docs/api-reference/cycle/list-cycles.md
  • docs/api-reference/cycle/remove-cycle-work-item.md
  • docs/api-reference/cycle/transfer-cycle-work-items.md
  • docs/api-reference/cycle/unarchive-cycle.md
  • docs/api-reference/cycle/update-cycle-detail.md
  • docs/api-reference/epics/get-epic-detail.md
  • docs/api-reference/epics/list-epics.md
  • docs/api-reference/estimate/add-estimate-points.md
  • docs/api-reference/estimate/add-estimate.md
  • docs/api-reference/estimate/delete-estimate-point.md
  • docs/api-reference/estimate/delete-estimate.md
  • docs/api-reference/estimate/get-estimate.md
  • docs/api-reference/estimate/list-estimate-points.md
  • docs/api-reference/estimate/overview.md
  • docs/api-reference/estimate/update-estimate-point.md
  • docs/api-reference/estimate/update-estimate.md
  • docs/api-reference/initiative/add-epics-to-initiative.md
  • docs/api-reference/initiative/add-initiative-label.md
  • docs/api-reference/initiative/add-initiative.md
  • docs/api-reference/initiative/add-labels-to-initiative.md
  • docs/api-reference/initiative/add-projects-to-initiative.md
  • docs/api-reference/initiative/delete-initiative-label.md
  • docs/api-reference/initiative/delete-initiative.md
  • docs/api-reference/initiative/get-initiative-detail.md
  • docs/api-reference/initiative/get-initiative-label-detail.md
  • docs/api-reference/initiative/list-initiative-epics.md
  • docs/api-reference/initiative/list-initiative-labels-for-initiative.md
  • docs/api-reference/initiative/list-initiative-labels.md
  • docs/api-reference/initiative/list-initiative-projects.md
  • docs/api-reference/initiative/list-initiatives.md
  • docs/api-reference/initiative/remove-epics-from-initiative.md
  • docs/api-reference/initiative/remove-labels-from-initiative.md
  • docs/api-reference/initiative/remove-projects-from-initiative.md
  • docs/api-reference/initiative/update-initiative-detail.md
  • docs/api-reference/initiative/update-initiative-label-detail.md
  • docs/api-reference/intake-issue/add-intake-issue.md
  • docs/api-reference/intake-issue/delete-intake-issue.md
  • docs/api-reference/intake-issue/get-intake-issue-detail.md
  • docs/api-reference/intake-issue/list-intake-issues.md
  • docs/api-reference/intake-issue/update-intake-issue-detail.md
  • docs/api-reference/issue-activity/get-issue-activity-detail.md
  • docs/api-reference/issue-activity/list-issue-activities.md
  • docs/api-reference/issue-attachments/complete-upload.md
  • docs/api-reference/issue-attachments/delete-attachment.md
  • docs/api-reference/issue-attachments/get-attachment-detail.md
  • docs/api-reference/issue-attachments/get-attachments.md
  • docs/api-reference/issue-attachments/get-upload-credentials.md
  • docs/api-reference/issue-attachments/update-attachment.md
  • docs/api-reference/issue-attachments/upload-file.md
  • docs/api-reference/issue-comment/add-issue-comment.md
  • docs/api-reference/issue-comment/delete-issue-comment.md
  • docs/api-reference/issue-comment/get-issue-comment-detail.md
  • docs/api-reference/issue-comment/list-issue-comments.md
  • docs/api-reference/issue-comment/update-issue-comment-detail.md
  • docs/api-reference/issue-types/options/add-dropdown-options.md
  • docs/api-reference/issue-types/options/delete-dropdown-options.md
  • docs/api-reference/issue-types/options/get-option-details.md
  • docs/api-reference/issue-types/options/list-dropdown-options.md
  • docs/api-reference/issue-types/options/update-dropdown-options.md
  • docs/api-reference/issue-types/properties/add-property.md
  • docs/api-reference/issue-types/properties/delete-property.md
  • docs/api-reference/issue-types/properties/get-property-details.md
  • docs/api-reference/issue-types/properties/list-properties.md
  • docs/api-reference/issue-types/properties/update-property.md
  • docs/api-reference/issue-types/types/add-issue-type.md
  • docs/api-reference/issue-types/types/delete-issue-type.md
  • docs/api-reference/issue-types/types/get-issue-type-details.md
  • docs/api-reference/issue-types/types/get-work-item-type-schema.md
  • docs/api-reference/issue-types/types/list-issue-types.md
  • docs/api-reference/issue-types/types/update-issue-types.md
  • docs/api-reference/issue-types/values/add-property-values.md
  • docs/api-reference/issue-types/values/delete-property-value.md
  • docs/api-reference/issue-types/values/get-property-value-detail.md
  • docs/api-reference/issue-types/values/list-property-values.md
  • docs/api-reference/issue-types/values/update-property-value.md
  • docs/api-reference/issue/add-issue.md
  • docs/api-reference/issue/advanced-search-work-items.md
  • docs/api-reference/issue/delete-issue.md
  • docs/api-reference/issue/get-issue-detail.md
  • docs/api-reference/issue/get-issue-sequence-id.md
  • docs/api-reference/issue/list-issues.md
  • docs/api-reference/issue/search-issues.md
  • docs/api-reference/issue/update-issue-detail.md
  • docs/api-reference/label/add-label.md
  • docs/api-reference/label/delete-label.md
  • docs/api-reference/label/get-label-detail.md
  • docs/api-reference/label/list-labels.md
  • docs/api-reference/label/update-label-detail.md
  • docs/api-reference/link/add-link.md
  • docs/api-reference/link/delete-link.md
  • docs/api-reference/link/get-link-detail.md
  • docs/api-reference/link/list-links.md
  • docs/api-reference/link/update-link-detail.md
  • docs/api-reference/members/add-project-member.md
  • docs/api-reference/members/delete-project-member.md
  • docs/api-reference/members/get-project-member-detail.md
  • docs/api-reference/members/get-project-members.md
  • docs/api-reference/members/get-workspace-members.md
  • docs/api-reference/members/remove-workspace-member.md
  • docs/api-reference/members/update-project-member.md
  • docs/api-reference/milestones/add-milestone.md
  • docs/api-reference/milestones/delete-milestone.md
  • docs/api-reference/milestones/get-milestone-detail.md
  • docs/api-reference/milestones/list-milestone-work-items.md
  • docs/api-reference/milestones/list-milestones.md
  • docs/api-reference/milestones/overview.md
  • docs/api-reference/milestones/update-milestone-detail.md
  • docs/api-reference/module/add-module-work-items.md
  • docs/api-reference/module/add-module.md
  • docs/api-reference/module/archive-module.md
  • docs/api-reference/module/delete-module.md
  • docs/api-reference/module/get-module-detail.md
  • docs/api-reference/module/list-archived-modules.md
  • docs/api-reference/module/list-module-work-items.md
  • docs/api-reference/module/list-modules.md
  • docs/api-reference/module/remove-module-work-item.md
  • docs/api-reference/module/unarchive-module.md
  • docs/api-reference/module/update-module-detail.md
  • docs/api-reference/page/add-project-page.md
  • docs/api-reference/page/add-workspace-page.md
  • docs/api-reference/page/get-project-page.md
  • docs/api-reference/page/get-workspace-page.md
  • docs/api-reference/project-features/get-project-features.md
  • docs/api-reference/project-features/overview.md
  • docs/api-reference/project-features/update-project-features.md
  • docs/api-reference/project-labels/add-project-label.md
  • docs/api-reference/project-labels/delete-project-label.md
  • docs/api-reference/project-labels/get-project-label-detail.md
  • docs/api-reference/project-labels/list-project-labels.md
  • docs/api-reference/project-labels/overview.md
  • docs/api-reference/project-labels/update-project-label-detail.md
  • docs/api-reference/project/add-project.md
  • docs/api-reference/project/archive-project.md
  • docs/api-reference/project/delete-project.md
  • docs/api-reference/project/get-project-detail.md
  • docs/api-reference/project/list-projects.md
  • docs/api-reference/project/unarchive-project.md
  • docs/api-reference/project/update-project-detail.md
  • docs/api-reference/state/add-state.md
  • docs/api-reference/state/delete-state.md
  • docs/api-reference/state/get-state-detail.md
  • docs/api-reference/state/list-states.md
  • docs/api-reference/state/update-state-detail.md
  • docs/api-reference/sticky/add-sticky.md
  • docs/api-reference/sticky/delete-sticky.md
  • docs/api-reference/sticky/get-sticky-detail.md
  • docs/api-reference/sticky/list-stickies.md
  • docs/api-reference/sticky/update-sticky-detail.md
  • docs/api-reference/teamspace/add-projects-to-teamspace.md
  • docs/api-reference/teamspace/add-teamspace-members.md
  • docs/api-reference/teamspace/add-teamspace.md
  • docs/api-reference/teamspace/delete-teamspace.md
  • docs/api-reference/teamspace/get-teamspace-detail.md
  • docs/api-reference/teamspace/list-teamspace-members.md
  • docs/api-reference/teamspace/list-teamspace-projects.md
  • docs/api-reference/teamspace/list-teamspaces.md
  • docs/api-reference/teamspace/remove-projects-from-teamspace.md
  • docs/api-reference/teamspace/remove-teamspace-members.md
  • docs/api-reference/teamspace/update-teamspace-detail.md
  • docs/api-reference/user/get-current-user.md
  • docs/api-reference/work-item-pages/add-work-item-page.md
  • docs/api-reference/work-item-pages/delete-work-item-page.md
  • docs/api-reference/work-item-pages/get-work-item-page-detail.md
  • docs/api-reference/work-item-pages/list-work-item-pages.md
  • docs/api-reference/work-item-pages/overview.md
  • docs/api-reference/worklogs/create-worklog.md
  • docs/api-reference/worklogs/delete-worklog.md
  • docs/api-reference/worklogs/get-total-time.md
  • docs/api-reference/worklogs/get-worklogs-for-issue.md
  • docs/api-reference/worklogs/update-worklog.md
  • docs/api-reference/workspace-features/get-workspace-features.md
  • docs/api-reference/workspace-features/overview.md
  • docs/api-reference/workspace-features/update-workspace-features.md
  • docs/api-reference/workspace-invitations/add-workspace-invitation.md
  • docs/api-reference/workspace-invitations/delete-workspace-invitation.md
  • docs/api-reference/workspace-invitations/get-workspace-invitation-detail.md
  • docs/api-reference/workspace-invitations/list-workspace-invitations.md
  • docs/api-reference/workspace-invitations/overview.md
  • docs/api-reference/workspace-invitations/update-workspace-invitation.md
  • docs/dev-tools/build-plane-app/oauth-scopes.md

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch refactor-update_developer_docs

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@iam-vipin iam-vipin self-assigned this Mar 16, 2026
@iam-vipin iam-vipin added the documentation Improvements or additions to documentation label Mar 16, 2026
@iam-vipin iam-vipin changed the title docs: refresh API reference and add new endpoints [DOCSW-615] docs: refresh API reference and add new endpoints Mar 16, 2026
@makeplane
Copy link

makeplane bot commented Mar 16, 2026

Linked to Plane Work Item(s)

This comment was auto-generated by Plane

Copy link
Member

@Saurabhkmr98 Saurabhkmr98 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM 🚀

@danciaclara danciaclara merged commit d5bc98a into master Mar 25, 2026
8 checks passed
@danciaclara danciaclara deleted the refactor-update_developer_docs branch March 25, 2026 14:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants